Higher programming language or assembly code? Because of market 
developments and evershortening design cycles, today’s software 
developers tend to employ higher programming languages like C orC+ 
for microcontoller applications. In many cases, this choice is more or 
less forced by requirements like program documentation, product sup- 
port and deadlines. However, higherlevel programming may not be 
possible when memory resources are limited, or when the application is 
time-critical. In such cases, an assembler supporting stuctured pogram- 
ming offers the best of both words, with high program speeds and 
clever memory usage thrown in as useful extras. 
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Based on examples from the past, 
including R.-D. Klein’s STRUKTA (1983), a 
CPM-compatible precompiler for 
Z80/8080 code, the author developed 
the SXp precompiler descnbed in this 
Elektor Electronics PC Topics article. As 
indicated by its name, SXp supports 
the microcontrollers from the ‘SX’ fami- 
ly supplied by Scenix[1, 2]. Statements 
for structured programming of interro- 
gation routines, branching and loops 
allow the high processing speed and 
optimum memory usage of assembly- 
code programming to be linked with 
those clearly laid out, easily created 
structures many of you have leamed 
to value of higher programming lan- 
guages like C. 
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Structured programming 

To begin with, a frequenty made eror 
should be eradicated: control state- 
ments for structured programming are 
not the same as conditional assembly, 
a feature available in almost any 
assembler package. Remarkably, many 
experts are not aware of this small but 
essential difference (“IF-THEN-ELSE, yes 
well my assembler does that too”). 


Control statements as they are made 

available by SXp allow structured 

programming in SX assembler lan- 

guage, with the following advan- 

tages: 

simplified program development and 
simplified debugging; 


vastly improved legibility of the pro- 
gram and its documentation; 

shorter program development cycles, 
resulting in higher productivity; 

improved program reliability and 
maintenance; 

more fun in wnting SX programs. 


SXp offers the programmer a set of 
statements to help him/her realize rou- 
tines (‘situations’) performing these 
functions: interrogation, branching or 
loops, as they occurin almost any pro- 
gram. Using assembly code program- 
ming, such standard routines are not 
easily made, and invanably subject to 
programming errors and doubts (like 
“is that carry flag set or not?”). 

The negative effect of the SXp state- 
ments on the code efficiency of the 
program is negligible if at all existent. 
In other words, both processor perfor- 
mance and memory usage are com- 
parable to what may be obtained with 
straight assembly code programming. 
When using SXp, all advantages of 
assembly code programming remain 
available simply because all non-SXp 
statements represent the regular 
assembly language commands. That, 
in a nutshell, is how it’s done! 


Xp — what's it for? 

SXp — for the Windows 95/98/NT plat- 
forms — isa precompiler capable of 
converting statements for structured 
programming (the so-called SXp state- 
ments) into assembly language code 
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for the Scenix SX family of microcon- 
trollers. 

The actual SX assembler commands 
are scattered between the SXp state- 
ments, and they remain unaffected by 
the SXp Precompiler. Of course, rou- 
tines may be nested by inserting any 
number of additional SXp statements. 
The code generated by SXp has to be 
converted into the final SX object 
code by a Scenix compatible assem- 
bler Note that only one-word basic 
commands of the SX are used. 

The assembler source code pro- 
gram created by SXp (that is, the out 
put file) may be used for simulation 
and debugging sessions (using, for 
example, SX-KEY™ from Parallax). 
Optionally, the SXp statements may be 
retained as comment in the assembly 
code file. This will be particularly useful 
with debugging. 

A further option is the inclusion of 
DEVICE CARRYX of the SX processor. 
This flag represents a useful speciality 
of the SX, although it must be said that 
it is also a troublesome feature. The 
CARRYX flag is used because the SX 
has no separate commands for addi- 
tion and subtraction with or without 
inclusion of the cary/borow bit. 

An essential feature of SXp is the 
exclusive use of the working register W, 
and, if necessary, the specified loop 
register No other SX registers are 
employed or modified (except, of 
course, the program counter and, 
occasionally, the status register). The 
SX stack is not used either by SXp. 
Consequently, the SX program creator 
has full and exclusive control over all 
SX registers. 

Depending on the programming 
method, SXp should achieve roughly 
the same code efficiency as pure 
assembly-code programming — but 
at the same time much better docu- 
mentation and program legibility is 
guaranteed, the upshot being that in 
the end you are having more fun! 

Depending on the memory configu- 
ration of the computer on which SXp is 
installed, all SXp structures may be nest 
ed to any depth. Because SXp doesnot 
employ the (relatively small) 8-level SX 
stack for its retum address information, 
Jumping is allowed at any location in 
the SX program, even into other SXp 
structures. With the previously men- 
tioned SIRUKIA program, great care 
was required in do doing so because 
this precompiler executed the retum 
jump from structures via the stack. 


What it can’t do 
SXp does not generate the SX object 
code directly from the SXp source pro- 
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gram. Because SXp is not aware of 
absolute program addresses, it is not 
capable of detecting page bound- 
aries (remember, the addressable 
memory range of the SX is organised 
as ‘pages’. In such cases, one of the 
SXp Page Mode Options should be 
employed [4]. 

Furthermore, SXp is unable to check 
if defined and actually used symbols 
and data are within their allowable 
range. Running this check remains the 
exclusive task of the assembler. 


SXp statements 

The statements implemented in version 
0.9 of SXp are summarized in Table 1. 
Extensive descriptions of all statements 
may be found in [3]. Below, some 
basic information is given regarding 
the SXp syntax. 

Instructions represents any number 
(including zero) of SX assembler instruc- 
tions and/or SXp statements. SXp state- 
ments may be nested to any depth. 
THEN is only used in combination with 


PAGE indicators, and may be omitted 
in all other cases. 

CONDITION represents comparisons (at 
least one SX register), register bit inter- 
rogations or status flag interrogations. 
REGISTER ASSIGN indicates the number 
of loop iterations. The specified register 
may have been loaded beforehand, 
or its assigning is part of the command. 
The loop register may be filled with a 
constant, the contents of another SX 
File Register, or the W register. 
ADDRESS stands for a non-local 
address at any location in the SXp pro- 
gram (take care, however, with jumps 
from subroutines). EXITIF-TO is the only 
non-structured SXp statement. It allows 
a code-saving and ‘quick way out’ of 
an SXp structure. An unconditional 
jump is simply programmed using the 
assembler command J MP 

SXp only uses the W register in the SX, 
plus the selected loop registers. 
Furthermore, the program counter and 
the status register are subject to modi- 
fications (the latter depending on 


Table 1. SXp Directives (SXp version 0.9.x ) 


| F CONDI TI ON [ THEN] 
Instructions 

ELSEIF Condition [ THEN] 
Instructions 

ELSE 
Instructions 

ENDI 

LOOP 
nist i Uke tle oms 

ENDL 

WHILE Condition 
Instructions 

ENDW 

REPEAT 
lnstructions 

UNTIL Condition 

FOR RegisterAssign 
[retort omnes 

ENDF 

EXIT 

EXITIF Condition 

EXITIF Condition TO Address 
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First interrogation 


More interrogations, 
multiple is optional 


Last branch, 
optional 


End oi IF structure 


Endless loop 

E OOP En DY 

means of 

EXIT EXI TIIE MP RET, 
Interrupt or SX reset 
End of LOOP 


Interrogation at start of 
loop 


End of WHILE | oop 


Start of loop 


Interrogation at end of 
loop 


Loop with 
register initialisation 


End of FOR |) was 


Leave one structure level 


Conditional exit from one 
structure level 


Conditional jump from one 
structure level 
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SXp program listing 1 


Square Root, SXp-Version by E. Haug, 27-]) UN- 1999 
8- bit result equals INT(SQRT(x)), therefore -0.99... accuracy 
; employs CARRYX fur 16-bit arithmetic! 
device pins28, pages4, Danks turbo, stackx, optionx, carryx, oscxt 

device SAZ Cur bo, StackX Opri on Carn yx. 0Scxt 2 ; A-type silicon 

id ' ROOT’ 

reset start ; Reset start address 

freq 1 000 000 ; takes <10 sec for all 64K possible SORTS 
freq 5 000 000 ; takes about 2 sec for all 64K possible SORTS 
freq 50 000 000 ; takes about 0.2 sec for 64K SQRTs, equals 

; approx. 3 usec on average per SQRT @ 50 MHz 
; Variable 
org $10 ; all reguired registers in the same bank 

inputl ds 1 
input 2 ds 1 
root mask ds 1 
Isbyte ds 1 ; Loop counter for MSByte 
msbyte ds 1 ; Loop counter for LSByte 


， 米 米 米 炒米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 
1 


org 0 ; Program starts at address $000 (not strictly required) 
start 
; the following two FOR loops are for estimating runtime only 
FOR msbyte = #256 0 
FOR | sbyte = #256 ; * 256 times, calculates all possible 64K SQRTs 
mo v w, msbyte 
mo v input2, w ; because input2 is modified 
mo v w,|sbyte 
mo v inputl, w ; because inputl is modified 
cal | SA OOt W E NTN SORT npu? T 
ENDF 
E NDF 
LOOP ; Simple delay loop (smallest SXp program) 
ENDL ; You could insert a break point here for runtime measurement 


， 米 米 米 炒米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 
1 


SH ROOT 

; This routine calculates the square root of a 16-bit unsigned number. 
* On entry: inputl - low byte of number, destroyed afterwards 

input2 - high byte of number, destroyed afterwards 

' On ext W register returns 8-bit result: W = INT(SQRT(input)) 


， 米 炒米 炒米 米 米 米 米 炒米 米 米 米 米 炒米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 炒米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 炒米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 
1 


Sa Toot 
mo v root mask, #$c0 ; Initialise root mask 
mo V w, #$40 mit ole result 
REPEAT 
stc l6 bit arithmetic (CARRYX)! 
sub input2, W ; Subtract result developed so far 
IF NC ; Undo subtraction when carry cleared 
add input2, w ; Carry not set here 
ELSE 
or w,root_ mask ; Set current bit 
ENDI 
LOOP ; Carry may be set or not at this point 
r | input 1 ; Shift number to the left by one position 
r | input? 
ii root mask Copy MOB Ith io mei no 
EXITIF NOT root_mask.7; End of LOOP when MSBit not set 
snc ; SKIP more effective here than IF-structure 
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retp ; Done when Carry set 
eels root mask. 7 
XOT w,root_ mask 
stc o Dit aritmetice CARRY Xn 
sub i nput2, w 
or w,root_ mask ; set current bit 
ENDL 
Xor w,root mask 
UNTIL C End of loop when LSBit of root mask 
shifted into Carry, else repeat 
sub input2, w 
IF C 
IF NZ If result <> 0 
xor w, #1 | Correct LSBDIT 
FESR En or if = 0 and MSBit set 
Xor w, #1 ; correct LSBit 
ENDI 
ENDI 
fet p ; Done! 
end End ot or or om 
interrogations). are printed in bold capitals. The SX an assembler/debugger utility. 


SXp employs the optional (and 
often wayward) DEVICE CARRYX bit. 

The risk of collisions with conditional 
assembler statements is avoided by 
Sxp: in the SXp source code file, it 
placesa question mark (?) immediate- 
ly before colliding statements (which 
may occur in a few assemblers only, 
Including the Parallax SX-KEY pack- 
age). The ? is also automatically 
removed again by SXp without taking 
any further action in the relevant line, 
so that all subsequent statements are 
available to the actual code-assem- 
bly operation. 

SXp statements may be written in 
Capitals, lowercase characters or a 
mixture of these. 

If SXp structures extend across SX 
page boundanies, the tools required to 
deal with such cases are available. 
However, these tools are not available 
in the demonstration version (inciden- 
tally, that is the only difference with the 
full version). 


Example 
After such a vast amount of theory to 
wade through we'd say it’s time for an 
example of an SXp source code pro- 
gram. The one to be discussed com- 
putes the square root of a 16-bit num- 
ber [5]. To be precise, the function is 
written as 
SQ ROOT = I NT(SQRT( NMBR) ) 
As a result of the 8-bit format of the 
output word, the rounding off per 
formed by the integer function may 
produce results that are up to 0.99 too 
low (just think of the square root of 
65,535 = 255.998...). With some extra 
effort, the result could be expanded 
into a 9-bit number, which would have 
a maximum eror of +0.5. 

For clanty’s sake all SXp statements 
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assembler commands appear in 
lowercase Characters (see Listing 1). 

The SXp source code program is wnt 
ten with any word processorcapable of 
producing ASCII output format. The file 
is Saved with the extension ‘.SXP’. With 
SXp up and running, this SXp file is then 
compiled after a number of options 
have been selected (in this case, the 
option ‘use CARRYX’ is enabled 
although the example doesnot include 
any SXp statements having compar 
isons; it has flag intermogations only). 

During the compilation process, SXp 
generates an SX assembler source 
code program with the extension 
‘SRC’. This program may also contain 
error reports with error pointers to line 
numbers of the SXp program. These 
reports allow you to quickly trace and 
eliminate programming errors. 

After compiling the SX assembler 
program may be assembled using SX- 
KEY™ or indeed any other assembler 
for Scenix SX micros, provided, of 
course, the mnemonics and syntax 
rules set out in the SX datasheets [1] 
are fully supported. DOS assemblers 
should also be suitable! 

The same SX assembler source 
code program may also be subjected 
to a debugging session using, for 
example, SX-KEY™. Optionally, all SXp 
statements may be retained as com- 
ment in the SX assembler source code 
file. This makes debugging much easi- 
er (fora better overview and checking 
the structure level is also produced). 
Thanks to the Windows operating sys- 
tem, there’s no need to quit SXp. It 
may remain in memory and quietly sit 
in the taskbar during the entire ‘design 
session’. In this way, you can quickly 
change back and forth between the 
text editor, the SXp precompiler and 


Code efficiency 

The currently available statements of 
SXp allow programmers to generate 
very efficient object code for SX 
micros. AS compared with pure 
assembly-level programming, less effi- 
cient code is obtained when an SXp 
statement contains just one single- 
word assembler instruction (no 
macro!). This occurs twice in the last ‘IF’ 
structure of the above example. 

This is caused by the SX assembler 
allowing one SX single-word instruction 
to be jumped over using (conditional) 
Skip instructions. These single-word 
commands are then not recognized 
as such by SXp, which substitutes inef- 
ficient jump instructions instead of a 
Skip instruction. If, however, more than 
one SX single-word instruction is found 
within SXp structures, there will be no 
differences in respect of efficiency. 

Separately compiled, the IF struc- 
ture mentioned above produces the 
SX assembler code shown in 
Listing 2. To keep the overview 
uncluttered, it is produced without the 
option ‘keep SXp Statements in output 
file’. 

For the above example, a nifty SX 
assembler code file [5] provides the 
result shown in Listing 3. 

Instead of the IF structure, this com- 
pact but difficult to analyse piece of 
assembler code could have been 
used in the SXp source code file 
instead of just in the IF structure. This 
would have resulted in the same effi- 
ciency for the SXp program. A single 
Conditional SKIP instruction should not 
affect program legibility too much 
(see also the example). However, we 
should repeat our waming: be careful 
with macros! 
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SXp program listing 2 


SC 
| MP l 
SNZ 
| MP M3 
XOT w, #1 Correction or moet 
) MP _L4 
les 
SB nO Ly 
| MP ols 
Mo w, #1 Correction Or ESBITt 
L4 
W5 
ole 
oll 
SXp program listing 3 
SC , AS SXp 
retp ; Already finished here! 
Snz , AS 9Xp 
snb apu ; Combined interrogation: 
xor w, #1 ANZORA ZAND TINON ET] 


SXp program listing 4 


REPEAT 
UNTIL Port.5 ' 


SXp program listing 5 


OL REPEAT 
oil 
01 UNTIL Ports 
SB Port S 
] MP ola 
a lke 


With pure delay loops, by the way, 
the REPEAFUNTIL structure is more effi- 
cient than the WHILE-ENDW structure 
because an interrogation is performed 
at the end of a REPEAT loop, resulting 
in one less jump instruction — see 
Listing 4. 

As you can see from Listing 5, the 
SX code generated by the precompil- 
eris hard to improve. 

Comparisons with a constant ‘0’ 
enables SXp to generate optimised 
code. In the above example, the FOR 
loops with 256 iterations (9-bit number) 
are executed as they should. More tips 
of this type, as well as descriptions of 
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wait 


for Port Bit 5 to be set 


wait 


for Port Bit 5 to be set 


typical programming emors may be 
found in the SXp manual [3]. 


Conclusion 
The SXp precompiler descnbed in this 
‘PC Topics’ article offers its user the pos- 
sibility to create structured assembler 
language programs for the SX micro- 
controllers from Scenix™. AS compared 
with higher programming languages, a 
modest amount of study is required to 
leam programming from scratch. This is 
mainly by virtue of the syntax which has 
been kept as simple as possible, clear 
and easy to remember. 

The code generated by SXp is effi- 


cient by most standards while you, the 
programmer, do not alienate from 
assembly-language programming 
and its typical environment, despite 
the use of structures. 


The efficiency of the precompiler 
descnbed here could no doubt be 
enhanced further if only multiple logic 
combinations (AND-OR) and quantity 
requests (IN, as in Pascal) would be 
allowed. Both were available many 
years ago in STRUKIA. Even better effi- 
ciency would be obtained if state- 
ments like SWITCH-CASE, ON-GOTO 
were implemented in SXp. Mind you, 
they are not yet implemented. 
Similarly, the rudimentary FOR-NEXT 
loop could be expanded into the 
more powerful FOR-TO -STEP structure. 

It would be desirable for the makers 
of SX assemblers to integrate at least 
the features of SXp into their products. 
Many years ago, there were intentions 
to do so forsome microcontroller fami- 
lies (for example, 68000 assemblers 
from Motorola, Mostek and Quelo). 
Today the same happens with 
Mitsubishi and Zlog, although the result 
ing products are cumbersome to use 
while offering fewer features than SXp. 

Finally, some C compilers also sup- 
port structured assembly-code pro- 
gramming in the integrated assembler. 
A good implementation is found with 
IAR, for example. In most cases, how- 
ever, the pnce tag of these products 
puts them well beyond the reach of 
hobbyists and occasional users. 

(992037-1) 
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